function [trchdr,trcdat,trcdef] = new ( obj, ntrace, nsamp, sampint )
%Returns a new trace data matrix (all zeros) and a new trace header struct
%
%function [trchdr, trcdat, trcdef] = new ( obj, ntrace, nsamp, sampint )
%
%    ntrace   = Number of traces
%    nsamp    = Number of samples per trace
%    sampint  = Sample interval in microseconds
%
%    trchdr   = Trace header struct
%    trcdat   = Trace data array (zeros)
%    trcdef   = Trace header definition cell array
%
% Examples:
%   [trchdr,trcdat,trcdef] = obj.new(ntrace,nsamp,sampint)
%
% Authors: Kevin Hall, 2017, 2019
%
% NOTE: This SOFTWARE may be used by any individual or corporation for any purpose
% with the exception of re-selling or re-distributing the SOFTWARE.
% By using this software, you are agreeing to the terms detailed in this software's
% Matlab source file.

% BEGIN TERMS OF USE LICENSE
%
% This SOFTWARE is maintained by the CREWES Project at the Department
% of Geology and Geophysics of the University of Calgary, Calgary,
% Alberta, Canada.  The copyright and ownership is jointly held by
% its 'AUTHOR' (identified above) and the CREWES Project.  The CREWES
% project may be contacted via email at:  crewesinfo@crewes.org
%
% The term 'SOFTWARE' refers to the Matlab source code, translations to
% any other computer language, or object code
%
% Terms of use of this SOFTWARE
%
% 1) This SOFTWARE may be used by any individual or corporation for any purpose
%    with the exception of re-selling or re-distributing the SOFTWARE.
%
% 2) The AUTHOR and CREWES must be acknowledged in any resulting publications or
%    presentations
%
% 3) This SOFTWARE is provided "as is" with no warranty of any kind
%    either expressed or implied. CREWES makes no warranties or representation
%    as to its accuracy, completeness, or fitness for any purpose. CREWES
%    is under no obligation to provide support of any kind for this SOFTWARE.
%
% 4) CREWES periodically adds, changes, improves or updates this SOFTWARE without
%    notice. New versions will be made available at www.crewes.org .
%
% 5) Use this SOFTWARE at your own risk.
%
% END TERMS OF USE LICENSE

narginchk(1,4)

if nargin <4
    sampint=[];
end
if nargin <3
    nsamp=[];
end
if nargin <2
    ntrace=[];    
end

trchdr = obj.newHeader(ntrace,nsamp,sampint);
if nargout > 1
    trcdat = obj.newData(ntrace,nsamp);
end
if nargout > 2
    trcdef = obj.HdrDef;
end

end  %end function